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Chapter 1 



Test Plan Overview 


This document contains a test plan for testing input values to the General Mission Analysis Tool (GMAT). The plan 
includes four primary types of information, which rigorously define all tests that should be performed to validate 
that GMAT will accept allowable inputs and deny disallowed inputs. The first is a complete list of all allowed object 
fields in GMAT. The second type of information, is test input to be attempted for each field. The third type of 
information is allowable input values for all objects fields in GMAT. The final piece of information is how GMAT 
should respond to both valid and invalid information. 

It is VERY important to note that the tests below must be performed for both the Graphical User Interface and 
the script!! The examples are illustrated using a scripting perspective, because it is simpler to write up. However, 
the test must be performed for both interfaces to GMAT. 


1.1 Tests to Verify Disallowed Fields are Rejected 


The tables contained in this document detail all allowed fields that the user should have access to in the GMAT user 
interfaces including the script and GUI. The tables are organized in terms of objects. Each object has a table that 
defines the allowable field names. The tables contain a complete definition of what object fields the user should have 
access to in the user interface. The user should not have access to or be able to set fields that are not contained in 
the field lists. This includes being able to set the field from the GUI or script, or seeing the field when the ’’Show 
Script 53 button is hit on the object’s associated dialogue box or a mission is saved. 

These following tests should be performed to ensme that the user does not have access to fields that are read 
only or some other type internal field. 


• Using show script and by saving missions, verify that only fields that are defined in the tables below are user 
settable and accessible. If a field name does not appear in the tables below, it should not appear in show script, 
or a saved mission. 

® Verify that the setting for fields in a saved mission and show script meet the allowable values. For example, 
currently if you hit show script on an OpenGL plot, you’ll see a line like this 


OpenGLPlotl . Viewpoint Vector * Vector; 

The word “Vector” is not an allowable value for the Viewpoint Vector field. 


® Try GHAT Object .DoesNotExist * 1 for all objects; 
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CHAPTER 1. TEST PLAN OVERVIEW 

1.2 Input Range Tests for Fields that Accept Numeric Values 


This section documents tests to be performed to ensure that GMAT accepts allowable values for numeric fields, and 
denies disallowed values. The tests apply to fields that accept real numbers or integers. The tests ensure that both 
allowed and disallowed values are attempted in the test process. 

The tests are described in Table 1.1. Let’s illustrate one of the tests and select the case where the input Is a 
real number such that Real > c. The ECC field on the Spacecraft object is in this category. According to the Table 
1.1, the tests to be performed on the ECC field are to try inputing values of -1, 0, 1, ’DoesNotExist’, and ’ ’ (Note: 
according to the notation in the table, c = 0 for the ECC field). In the GMAT script syntax, the tests to be performed 

on the ECC field are: 


GMAT DefaultSC.ECC 
GMAT DefaultSC.ECC 
GMAT DefaultSC.ECC 
GMAT DefaultSC.ECC 
GMAT DefaultSC.ECC 


- 1.0 

0.0 

1.0 

DoesNotExist 


We see in Table 2.1 that the allowable options are ECC> 0, so we know that only the second and third lines above 
should pass the test. The first, fourth, and fifth lines should throw an error message consistent with the format 

discussed in Sec. 1.4. 


Table 1.1: Input Range Tests for Fields that Accept Real Numbers and Integers 


Allowable Input Type 

Test Input 

Real 

- 1.01 . 1.01 , 'DoesNotExist 5 , 5 5 

Real > c 

e-1 , c , c+1 , ‘DoesNotExist 1 , 5 1 

Real < c 


Real > c 


Real < c 


Real 7 ^ c 


Ci > Real > c 2 

c, - 1, Cl, (cx + «jj)/2, 02, c2 + 1, ‘DoesNotExist’ , ’ ’ 

ci > Real > c 2 

Ci - 1 , Ci, (ci + 02 ) 72 , 02 , c2 + 1 , ‘DoesNotExist’ . ’ ’ 

Integer 

-1, 1, 1.01 j 'DoesNotExist 5 , 5 5 

Integer > c 

c-0.5, c - 1 , c , c + 0.5 , c+ 1 . ‘DoesNotExist’ , ’ ’ 

Integer < c 


Integer > c 


Integer < c 


Ci > Integer > e 2 

Cl - 0.5, Cl , ronnd((ci -f c^)/2), e 2 , c2 -b 0.5 , ’DoesNotExist 5 , 5 5 

Ci > Integer > c 2 

C] - 0.5, c;i , round (( ci A c 2 )/2), c 2 , c2 -f 0.5 , 'DoesNotExist 5 , 5 5 


1.3 Input Range Tests for Fields that Accept Strings 

There are numerous fields in GMAT that accept strings as input values. For some fields, the list of strings that are 
acceptable is predefined, and the user cannot add to the list of possible values. A good example of this type of field is 
the StateType field on the Spacecraft object. The allowable inputs for the StateType are restricted to the following: 
Cartesian, Keplerian, Modif iedKeplerian, SphericalAZFPA, SphericalRADEC, Equinoctial . The user cannot 

add to this list. 

The second type of field that accepts strings as input is best illustrated by the CoordinateSystem field on the 
Spacecraft object. For the CoordinateSystem field, the user can select from the default list of coordinate systems 
such as EarthMJ2000£q, EarthMJ2000Ec, or EarthFixed. However, the user can also select from any user-defined 
coordinate system. So if the user has defined a coordinate system called EarthSunRotating, then they can choose 
this as the coordinate system defined by the CoordinateSystem field object on the Spacecraft object. 
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1.4 . BEHAVIOR WHEN A DISALLOWED OBJECT FIELD IS ENCOUNTERED 

For ail string fields we should test that numeric values (use 1.0 for value) and the string DoesNotExist are not 
accepted by GMAT. Now let’s look at the tests for these two types of fields. 


1.3.1 Tests for Strings that are Restricted to a Predefined List 

For the first type, where the user can only select from a list of predefined strings, we should attempt two of the 
strings. The first should be the default value, the second should not be a default value. As an example, for the 
StateType field on the spacecraft object, we should test the following two inputs: 


Default SC. St at eType = Cartesian; 
Def ault SC . StateType » Keplerian; 


We should perform similar tests for all fields of this type. 


1.3.2 Tests for Strings that are not Restricted to a Predefined List 

For the .second type of string input, where the user can select from a predefined list of strings as well as a user defined 
list, we should test one value from the predefined list. Then we should create an object of the type appropriate to 
the field, and test that the object name can be used as input to the field. Let’s look again at the CoordinateSystem 
field on the spacecraft object as an example. We should perform the following: 


Create CoordinateSystem MyCoordSys; 

Def ault SC. CoordinateSystem = EarthMJ2000Eq: 
Def ault SC. CoordinateSystem = MyCoordSys: 


We should perform similar tests for all fields of this type. 


1.4 Behavior When a Disallowed Object Field is Encountered 

There are two types of error handling described in this section. The first, is when a user tries to set a field that does 
not exist, or that the user is not allowed access to. The second type, is when the user tries to set an allowed field, 
but does not use an allowable setting for the field. 


1.4.1 Error Message for a Disallowed Field 

If a field that is not allowed is encountered by GMAT, GMAT should output the following error message: 
The field name u ” on object w ” is not permitted. As an example, if the user inputs the following, 

Def aultSC .DoesNotExist = 5 

then GMAT should respond with the following error message: 


The field name “DoesNotExist” on object Defaults C is not permitted. 



**• 

| 

IQ 

1.4.2 Error Message for an Invalid Input for an Allowed Field 

If the user inputs a disallowed value for an allowed field GMAT should respond with the following message 

The value of “ ” for field “ ” on object w ” is not an allowed value. The allowed values are: [insert options here]. 

For example, if the user input the following line of script 

Def aultSC . StateType = DoesNotExist 

then GMAT should respond with the following error message: 

The value of DoesNotExist for field StateType on object Defaults C is not an allowed value. The allowed values 
are: [Cartesian, Keplerian, Modif iedKeplerian, SphericalAZFPA, SphericalRADEC , Equinoctial]. 

The allowed values for all other fields are found in the the tables below. 

1.5 Notes 

ABM integrator settings. 

For Differential corrector, UseCentralDifferencing is not implemented in base code. 

Normalization of quaternion, are we doing this? 

Changed TargetStatus to Solverlterations on XYplots and OpenGL plots, and added the field to Reports. 

The following fields have been changed according to this document 
SolarSystem.RotationDataSource = DE405 or false IAU2002 (used to be 0 or 1) 

Equinoctial elements have changed from the labels on the GUI. 

Spacecraft . DateFormat -> Spacecraft .EpochFor mat for consistency with the rest of GMAT 

ABM integrator settings changed 

Lower Err or -> MinlutegrationError 
TargetError -> NomlntegrationError 
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Chapter 2 



Objects and Resources 

2,1 Spacecraft and Hardware Fields 


Table 2.1: Fields Associated with a Spacecraft Orbit State 
(Orbit Tab) 


Field 

Options and Description 

St ate Type 

Default: Cartesian. Options: [Cartesian, Keplerian, 

Modif iedKeplerian, SphericalAZFPA, SphericalRADEC, Equinoctial ]. 
The StateType field allows the user to configure the type of state vector 
that they wish to use. The Statetype field has a dependency upon the 
CoordinateSystem field. If the Coordinate System chosen by the user 
does not have a gravitational body at the origin, then the state types 
Keplerian, Modif iedKeplerian, and Equinoctial are not permitted. 
This is because these state types require a \i value. Units: N/A. When the 
Keplerian or Modif iedKeplerian state types are selected, the Anomaly 
Type field becomes visible. 

Coordinate System 

Default: EarthMJ2000Eq. Options: [ EarthMJ2000Eq, EarthMJ2O0GEc, 
EarthFixed, or any user defined system]: The Coordinate System field 
allows the \iser to choose which coordinate system with which to define the 
orbit state vector. The CoordinateSystem field has a dependency upon 
the StateType field. If the Coordinate System chosen by the user does not 
have a gravitational body at the origin, then the state types Keplerian, 
Modif iedKeplerian, and Equinoctial are not permitted. This is because 
these state types require a /i value. Units: N/A. 

EpochFormat 

Default: TAIModJulian. Options: [AlModJulian, TAIMod Julian, 

UTCModJulian, TTModJulian, AlGregorian, TAIGregorian, 

UTCGregorian, TTGregorian ]: The DateFormat field allows the user to 
specify the format for defining a spacecraft’s initial epoch. DateFormat 
determines both the time system (TAI, TT, etc) and the time format 
(MJD or Gregorian). Units: N/A. 

Epoch 

Default: 21545.000000000. Options: [See Comments]: The Epoch field 
allows the user to specify the initial spacecraft epoch. The format of the 
epoch must be consistent with the DateFormat field. If DateFormat is of the 
“MJD” type, then the epoch is in Modified Julian format. If DateFormat 
is a “Gregorian Type”, the format is similar to 01 Jan 2000 12:00:00.000. 
Units: MJD - days, Gregorian - N /A. 
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CHAPTER T OBJECTS AND RESOURCES 


Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 

Field Options and Description 

AnomalyType Default: TA. Options: [ TA, HA, EA, HA]: The Epoch field allows the 

user to specify the to select the AnomalyType needed for the Keplerian 
or Modif iedKeplerian spacecraft state. In the scripting environment, 
AnomalyType is not used. Units: N/A. 


Fields associated with Cartesian state. 


X 


Y 


Z 


VX 


VY 


vz 


SKA 


Default: 7100. Options: [ Real Number ]: X is the x-component of 
the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Default: 0. Options: [ Real Number ]: Y is the y-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Default: 1300. Options: [ Real Number ]: Z is the z-component of 
the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Default: 0. Options: [ Real Number ]: VX is the x-component of the 
Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

Default: 7.35. Options: [ Real Number ]: VY is the y-component of 
the Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

Default: 1.0. Options: [ Real Number ]: VZ is the z-component of 

the Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

NOTE: Default values for the remaining state types are obtained through 
transformations of the default Cartesian spacecraft state values. The 
Keplerian, Modif iedKeplerian, and Equinoctial are dependant on the 
origin of the CoordinateSystem, because the state types require a \i value. 


Fields associated with Keplerian state. 

Default: 7191.938817629. Options: [Real Number ^ 0 ]: The SMA field 
is the spacecraft orbit’s osculating Keplerian semimajor axis in coordinate 
system chosen in the Spacecraft CoordinateSystem field. SMA must be 
strictly greater than or less than zero. For circular and elliptical (0 < ECC 
< 1) orbits SMA should only be a positive Real Number and for hyperbolic 
orbits (ECC > 1) SMA should only be a negative Real Number. GMAT 
does not support the creation of parabolic orbits. Units: km. 



2. 1 . SPACECRAFT AND HARDWARE FIELDS 


Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field Options and Description 

ECC " " " “ " ~ " Default: 0.024549749. Options: [ 0 < Real Number, ECC# 1 ]: The ECO 

field is the spacecraft orbit’s osculating eccentricity. ECC must be greater 
than or equal to zero but not equal to one (GMAT does not support 
parabolic orbits). Note: ECC can be greater thanone. See the SMA de- 
scription for additional restrictions to the allowable values of ECC. Units; 
Dimensionless. 

INC Default: 12.850080057. Options: [Real Number]: The INC field is the 

spacecraft orbit’s osculating inclination, in degrees, w/r/t to the selected 
coordinate system. Units: degrees. 

AGP Default: 314.190551536. Options: [Real Number]:The AOP field is the 

spacecraft orbit’s osculating argument of periapsis, in degrees, w/r/t to the 
selected coordinate system. Units: degrees. 

RAAN Default: 306.614802195. Options: [Real Number]: The RAAN field is 

the spacecraft orbit’s osculating right ascension of the ascending node, in 
degrees, w/r/t to the selected coordinate system. Units: degrees. 

TA Default: 99.887749332. Options: [Real Number]: The TA field is the space- 

craft orbit’s osculating true anomaly. Units: degrees. 

MA Default: 97.107826639, Options: [Real Number]: The MA field is the 

spacecraft orbit’s osculating mean anomaly. Units: degrees. 

EA Default: 98.498977103. Options: [Real Number]: The EA field is the space- 

craft orbit’s osculating eccentric anomaly. Units: degrees. 

HA Default: 0.000000000. Options: [Real Number]: The HA field is the space- 

craft orbit’s osculating hyperbolic anomaly. Units: degrees. 


RadApo 


RadPer 


INC 

AGP 


Fields associated with Modif iedKeplerian state. 

Default: 7015.378524789. Options: [Real Number ^ 0 ]: The RadApo field 
is the spacecraft orbit’s osculating radius of apoapsis. RadApo must be 
strictly greater than or less than zero. When RadApo is negative, the orbit 
is hyperbolic. Units: km. 

Default: 7368.4991104681 Options: [Real Number > 0 ]: The RadPer field 
is the spacecraft orbit’s osculating radius of periapsis. RadPer must be 
greater than zero. Units: km. 

See the Keplerian state section for a description on this field. 

See the Keplerian state section for a description on this field. 


RAAN 


See the Keplerian state section for a description on this field. 


TA 


See the Keplerian state section for a description on this field. 


MA 


See the Keplerian state section for a description on this field. 
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Table 2,1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 


Options and Description 


EA 

HA 


See the Kepler lan state section for a description on this field. 
See the Kepler i an state section for a description on this field. 


RMAG 


RA 


DEC 


VMAG 


AZI 


FPA 


Fields associated with SphericalAZFPA state. 

Default: 7218.03297304. Options: [Real Number > 0): The RMAG field 
allows the user to set the magnitude of the spacecrafts position vector. 
Units: km. 

Default: 0. Options: [Real Number]: The RA field allows the user to set 
the spacecraft’s right ascension. Units: degrees. 

Default: 10.3758449200. Options: [Real Number]: The DEC field allows the 
user to set the spacecraft’s declination. Units: degrees. 

Default: 7.41771528167. Options: [Real Number > 0]: The VMAG field 
allows the user to set the magnitude of the spacecraft’s velocity. Units: 
km/sec. 

Default: 82.377421681. Options: [Real Number]: The AZI field allows the 
user to set the spacecraft’s azimuth angle. Units: degrees. 

Default: 88.60870365370. Options: [Real Number]: The FPA allows the 
user to set a spacecraft’s flight path angle. Units: degrees. 


RMAG 

RA 

DEC 

VMAG 

RAV 

DECV 


Fields associated with SphericalRADEC state. 

See the SphericalAZFPA state section for a description on this field. 

See the SphericalAZFPA state section for a description on this field. 

See the SphericalAZFPA state section for a description on this field. 

See the SphericalAZFPA state section for a description on this field. 

Default: 90. Options: [Real Number]: The RAV field i allows the user to set 
the right ascension of the spacecraft’s velocity. Units: degrees. 

Default: 7.7477720361. Options: [Real Number]: The DECV field allows the 
user to set the declination of the spacecraft’s velocity. Units: degrees. 


SMA 


Fields associated with Equinoctial elements. 
See the Keplerian state section for a description on this field. 
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Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 

Options and Description 

h 

Default: -0.024234314. Options: [Real Number]: The h field is the projec- 
tion of the eccentricity vector onto the y ep axes. The P ep system is a system 
used in calculating the equinoctial elements and is beyond the scope of this 
discussion. The GMAT Mathematical Specifications document discusses 
IF zp and the calculation of the equinoctial elements in detail. Units: None. 

k 

Default: -0.003922779. Options: [Real Number]: The k field is the projec- 
tion of the eccentricity vector onto the x ep axes. The T ep system is a system 
used in calculating the equinoctial elements and is beyond the scope of this 
discussion. The GMAT Mathematical Specifications document discusses 
Pep and the calculation of the equinoctial elements in detail. Units: None. 

P 

Default: -0.090388347. Options: [Real Number]: The p field is the projec- 
tion of the N vector onto the y ep axes. The N vector and the F ep system 
are used in calculating the equinoctial elements and are beyond the scope 
of this discussion. The GMAT Mathematical Specifications document dis- 
cusses N and P ep and the calculation of the equinoctial elements in detail. 
Units: None. 

q 

Default: 0.067164549. Options: [Real Number]: The q field is the projec- 
tion of the N vector onto the x ep axes. The N vector and the F ep system 
are used in calculating the equinoctial elements and are beyond the scope 
of this discussion. The GMAT Mathematical Specifications document dis- 
cusses N and P ep and the calculation of the equinoctial elements in detail. 
Units: None, 

MeanLongitude 

Default: 3.16359946. Options: [Real Number]: The MeanLongitude field 
is the the spacecraft’s mean longitude. The GMAT Mathematical Spec- 
ifications document discusses mean longitude and the calculation of the 
equinoctial elements in detail. Units: degrees. 

Table 2.2: Fields Associated with Spacecraft Physical Properties 
(Ballistic/Mass Tab) 

Field 

Options and Description 

DryMass 

Default: 850. Options: [Real Number > 0]: The DryMass field allows the 
user to specify the mass of the spacecraft structure, but does not include 
the mass of tanks, thrusters, or fuel. Units: kg. 

Cd 

Default: 2.2. Options: [Real Number > 0]: The Cd field allows the user to 
specify the spacecraft’s drag coefficient. Units: None. 

Cr 

Defatilt: 1.8. Options: [Real Number > 0]: The Cr field allows the user to 
specify the spacecraft’s coefficient of reflectivity. Units: None. 

DragArea 

Default: 15. Options: [Real Number > 0]: The DragArea is the effective 
spacecraft area used in calculate the force due to drag. Units: m 2 . 
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Table 2.2: (Fields Associated with Spacecraft Physical Properties 
(Orbit Tab), continued) 


Field Options and Description 

SEP Area Default: 1. Options: [Real Number > 0]: The SRPArea is the effective 

spacecraft area used in calculate the force due to solar radiation pressures. 
Units: m 2 . 


Table 2.3: Fields Associated with Spacecraft Attitude State 
(Attitude Tab) 


Field 

Attitude 

Mode 


Attitude 

Coordinate 

System 


Attitude 

StateType 


Attitude 

Rate 

StateType 

Euler 

Angle 

Sequence 


Options and Description 

Default: CSFixed. Options: [ CSFixed, Spinner]: The AttitudeMode mode field allows the 
user to specify the attitude dynamics model to be used by GMAT to propagate a spacecraft’s 
attitude. The attitude dynamics model uses the initial attitude state and the algorithm 
associated with AttitudeMode to advance the attitude state in time. Units: N/A. 

Default: EarthMJ2000Eq. Options: [ Earth.MJ2000Eq, EarthMJ2000Ec, EarthMJ2000£q, 
or any user defined system]: A spacecraft’s initial body axes orientation as defined 

by the quaternions or some other p ararne ter izat ions are expressed with respect to the 
AttitudeCoordinateSystem. Unlike an orbit state, an attitude state is really informa- 
tion that uniquely defines a rotation matrix. A spacecraft’s attitude is the orientation of 
the spacecraft’s body-fixed frame with respect to the inertial frame. However, it is often 
more convenient to define the initial attitude with respect to an intermediate frame than 
with respect to an inertial frame. The Attitude CoordinateSystem allows the user to 
define the initial orientation of a spacecraft’s body axes, with respect to any frame GMAT 
knows how to calculate. Units: N/A. 

Default: Euler Angles. Options: [Euler Angles, Quaternions, DCM]: The 

AttitudeStateType field allows the user to choose among different attitude parame- 
terizations when defining the attitude initial conditions. Units: N/A. 

Default: EulerAngleRates. Options: [Euler AngleRates, AngularVelocity]: ■ The 

AttitudeRateStateType field allows the user to define the attitude parameterization to 
be used in defining the initial attitude rate. Units: N/A. 

Default: 312. Options: [ 123, 132, 121, 131, 213, 231, 212, 232, 312, 321, 313, 
323 ]: The EulerAngleSequence field allows the user to define the Euler sequence used in 
rotating from the body-fixed to the inertial axes. For example, if EulerAngleSequence is 
selected as 321, then the first rotation is a 3 rotation through EulerAnglel, the second 
rotation is a 2 rotation through EulerAngle2, and the third rotation is a 1 rotation through 
EulerAngle3. Units: N/A. 


Fields associated with Spacecraft Attitude State 

EulerAnglel Default: 0. Options: [Real Number]: EulerAnglel is one of three Euler angles that can be 
used to define the initial conditions of a spacecraft. EulerAnglel corresponds to the first 
rotation performed in the sequence that goes from the spacecraft body frame to the inertial 
frame. For example, if the EulerAngleSequence field is set to 321, the first rotation from 
the body to the inertial frame would be a 3-rotation throughEulerAnglel. Units: degrees. 
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Table 2.3: (Fields Associated with Spacecraft Attitude State 
(Attitude Tab) ....continued) 

Field Options and Description ~~~~ ~ ” — ~~~ 

^ulerAngle~2~ Default: 0. Options: [Real Number]: EulerAngle2 is one of three Euler angles that can be 
used to define the initial conditions of a spacecraft. EulerAngle2 corresponds to the second 
rotation performed in the sequence that goes from the spacecraft body frame to the inertial 
frame. For example, if the EulerAngleSequence field is set to 321, the second rotation from 
the body to the inertial frame would be a 2-rotation throughEulerAngle2. Units: degrees. 

EulerAngle3 Default: 0. Options:[Real Number]: EulerAngle3 is one of three Euler angles that can be 
used to define the initial conditions of a spacecraft. Euler Angle3 corresponds to the third 
rotation performed in the sequence that goes from the spacecraft body frame to the inertial 
frame. For example, if the EulerAngleSequence field is set to 321, the third rotation from 
the body to the inertial frame would be a 1-rotation through£ulerAngle3. Units: degrees. 

ql Default: 0. Options: [Real Number]: The ql parameter is the first element of the quaternion. 

GMAT normalizes the quaternion to be of length 1. Units: degrees. 

q2 Default: 0. Options: [Real Number]: The q2 parameter is the second element of the quater- 

nion. GMAT normalizes the quaternion to be of length 1. Units: degrees. 

q3 Default: 0. Options: [Real Number]: The q3 parameter is the third element of the quaternion. 

GMAT normalizes the quaternion to be of length L Units: degrees. 

q4 Default: 1. Options:[Real Number]: The q4 parameter is the fourth element of the quater- 

nion. GMAT normalizes the quaternion to be of length 1. Units: degrees. 

DCM11 Default: 1. Options: [Real Number]: The DCM11 parameter is the upper left component of 

the direction cosine matrix that rotates from the spacecraft body frame to the inertial frame. 
GMAT normalizes the attitude matrix to have a determinant of 1. The default DCM matrix 
is the identity matrix. Units: None. 

DGM12 Default: 0. Options: [Real Number]: The DCM 12 parameter is the R \2 component of the 

direction cosine matrix that rotates from the spacecraft body frame to the inertia! frame. 
GMAT normalizes the attitude matrix to have a determinant of 1. The default DCM matrix 
is the identity matrix. Units: None. 

DCM33 Defatilt: 1. Options: [Real Number]: The DCM33 parameter is the R 33 component of the 

direction cosine matrix that rotates from the spacecraft body frame to the inertial frame. 
GMAT normalizes the attitude matrix to have a determinant of 1. The default DCM matrix 
is the identity matrix. Units: None. 

Euler Angle Default: 0. Options: [Real Number]: The EulerAngleRatei defines the time-rate-of-change 

Ratel of Euler Anglel, expressed in the the system defined by Att itudeCoordinat eSystem. Units: 

deg/sec. 

Euler Angle Default: 0. Options: [Real Number]: The EulerAngleRate2 defines the time-rate-of-change 

Rat e2 of Euler Angle2, expressed in the the system defined by Att itudeCoordinat eSystem. Units: 

deg/sec. 

Euler Angle Default: 0. Options: [Real Number]: The EulerAngleRate3 defines the time-rate-of-change 

Rate3 of Euler Angle3, expressed in the the system defined by Att itudeCoordinat eSystem. Units: 

deg/sec. 
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Table 2.3: (Fields Associated with Spacecraft Attitude State 
(Attitude Tab) ....continued) 


Field Options and Description 

Angular Default: 0. Options:[Real Number]: The AngularVelocityX component is the x- 

VelocityX component of the spacecraft’s body axes with respect to the system defined by 
AttitudeCoordinateSystem. Units: deg/sec. 


Angular Default: 0. Options: [Real Number]: The AngularVelocityY component is the y- 

VelocityY component of the spacecraft’s body axes with respect to the system defined by 
AttitudeCoordinateSystem, Units: deg/sec. 


Angular Default: 0. Options: [Real Number]: The AngularVelocityZ component is the z- 

VelocityZ component of the spacecraft’s body axes with respect to the system defined by 

AttitudeCoordinateSystem. Units: deg/sec. 


Table 2.4: Fields Associated with a Spacecraft Tank (Tanks Tab) 


Field 

Options and Description 

FuelMass 

Default: 756. Options; [Real Number > 0]: The FuelMass field is the mass 
of fuel in the tank. Units: kg. 

Pressure 

Default: 1500. Options: [Real Number > 0]: The Pressure field is the 
pressure of the fuel in the tank. Units: kPa. 

Temperature 

Default: 20. Options: [Real Number]: The Temperature field is the tem- 
perature of the fuel in the tank. Units: C. 

Ref Temperature 

Default: 20. Options: [Real Number]: Ref Temperature Units: C. 

Volume 

Default: 0.75. Options: [Real Number > 0]: The Volume field is the volume 
of the tank. Units: m 3 . 

FuelDensity 

Default: 1260. Options: [Real Number > 0]: The FuelDensity parameter 
is the fuel density. Units: kg/m 3 

P r e s sur eRegul at ed 

Default: true. Options: [true false]: The Pressur eRegul at ed flag allows 
the user to choose between a pressure regulated tank or a blow down tank. If 
PressuxeRegulated is true, then the pressure is held constant as fuel mass 
is depleted. If Pres sur eRegul at ed is false, then the pressure decreases as 
fuel is depleted. 
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Table 2.5: Fields Associated with a Spacecraft Thruster 
(Actuators Tab) 


Field 

Options and Description 

CoordinateSystem 

Default: EarthMJ2000Eq. Options: [ EarthMJ2000Eq, £axthMJ2000Ec, 
EarthMJ2000Eq, or any user defined system]: The CoordiuateSystem field 
for a thruster determines what coordinate system the orientation parame- 
ters X_Direction, YJ)irection, and Z_Direction are referenced to. This 
is a temporary fix in GMAT. Eventually, the user will specify the attitude 
of a spacecraft, and then XJ)irection, Y_Direction, and Z_Direction will 
be referenced to the spacecraft body frame. 

Axis 

Default: VNB. Options: [Inertial VNB]: The Axis field allows the user to 
define a local coordinate system for a thruster. Note that there is a coupling 
between the Axis parameter and the CoordinateSystem parameter for a 
thruster. Only one of the two can be specified. Units: N/A. 

Origin 

Default: Earth. Options: [Sun, Mercury, Venus, Earth, Luna, Mars, 

Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Origin field allows the 
user to define a local origin for a thruster. Note that there is a coupling 
between the Origin parameter and the CoordinateSystem parameter for 
a thruster. Only one of the two can be specified. Units: N/A. 

XJ)irection 

Default: 1. Options: [Real Number]: X_Direction, divided by the RSS 
of the three direction components, forms the x direction of the spacecraft 
thrust vector direction. 

Y_Direction 

Default: 0. Options: [Real Number]: Y_Direction, divided by the RSS 
of the three direction components, forms the y direction of the spacecraft 
thrust vector direction. 

Z_Direction 

Default: 0. Options: [Real Number]: ZJDirection, divided by the RSS 
of the three direction components, forms the z direction of the spacecraft 
thrust vector direction. 

ThrustScaleFactor 

Default: 1. Options: [Real Number > 0]: ThrustScaleFactor is a scale 
factor that is multiplied by the thrust vector for a given thruster, before 
the thrust vector is added into the total accleration. Units: None. 

Tank 

Default: None. Options: [Tank Name]: The Tank field specifies which tank 
the thruster draws propellant from. 

The constants C{ below are used in the following equation to calculate 
thrust F t as a function of pressure P and temperature T 

Ft(P,T ) = {C\ + C 2 P + C 3 P 2 + C 4 P Cr ’ + CgP Ct + C%P c * 

\ / nr \ 

+C '“ C K”1(^) 

Cl 

Default: 500. Options: [Real Number]: Thrust coefficient. Units: N 

C2 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: N/kPa. 

C3 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: N/kPa 2 
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Field 

C4 

C5 

G6 

C7 

C8 

G9 

CIO 

Cll 

C12 

C13 

C14 


K1 

K2 

K3 

K4 

K5 

K6 

K7 

K8 

K9 


Table 2.5: Fields Associated with a Spacecraft Thruster 
(Actuators Tab) (continued) 


Options and Description 


Default: 0. Options: [Real Number]: Thrust coefficient. Units: N/kPa C5 . 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: None 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: N/kPa C7 . 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: None 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: N/kPa C9 . 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: None 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: N. 

Default: 1. Options: [Real Number]: Thrust coefficient. Units: None 

Default: 0. Options: [Real Number]: Thrust coefficient. Units: 1/kPa. 

Default: 0, Options: [Real Number]: Thrust coefficient. Units: None. 

Default: 0. Options: [Real Number]: Thrust coefficient. Units 1/kPa. 

The constants Ki below are used in the following equation to calculate Isp 
as a function of pressure P and temperature T 

I sp (P, T) = {ifi + K 2 P + K 3 P 2 + K a P k * + K 6 P K7 + K S P K > + K 10 K“” P } 


( 


/Ji \ 14-^13 + ^ 14 ^ 

Eref ) 


Default: 2150. Options: [Real Number]: Isp coefficient. Units: m/sec 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec* kPa). 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec- kPa 2 ) 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec* 

kPa K5 ). 

Default: 0. Options: [Real Number]: Isp coefficient. Units: None 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec- 

kPa* 7 ). 

Default: 0. Options: [Real Number]: Isp coefficient. Units: None 
Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec* kPa K9 . 
Default: 0. Options: [Real Number]: Isp coefficient. Units: None 
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Table 2.5: Fields Associated with a Spacecraft Thruster 
(Actuators Tab) (continued) 

Field Options and Description 

K10 Default: 0. Options: [Real Number]: Isp coefficient. Units: m/sec. 

Kll Default: 1. Options: [Real Number]: Isp coefficient. Units: None 

K12 Default: 0. Options: [Real Number]: Isp coefficient. Units: 1/kPa. 

K13 Default: 0. Options: [Real Number]: Isp coefficient. Units: None. 

K14 Default: 0. Options: [Real Number]: Isp coefficient. Units 1/kPa. 


2.2 Propagator Fields 


Table 2.(1: Fields Associated with a Force Model 


Field Options and Description 

CentralBody Default: Earth.. Options: [ Sun, Mercury, Venus, Earth, Luna, 

Mars, Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Gen-, 

tralBody field allows the user to select the origin for the propaga- 
tion. All propagation occurs in the FK5 axes system, about the 
CentralBody chosen by the user. The CentralBody must be a grav- 
itational body and so cannot be a LibrationPoint or other special 
point. Units: N/A. 

PrimaryBodies Default: {Earth}. Options: [ Sun, Mercury, Venus, Earth, Luna, 

Mars, Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Pri- 

maryBodies field is a list of all celestial bodies that are to be 
modelled with a force model more complex than point mass grav- 
ity. Lists are surrounded by curly braces. For each PrimaryBody, 
the user can choose a drag, magnetic field, and aspherical gravity 
model. There is a coupling between the PrimaryBodies filed and 
the PointMasses field. A primary body can be any planet or moon 
not included in the PointMasses field. Units: N/A. 
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Table 2.6: (Fields Associated with a Force Mo del... cod turned) 


Field Options and Description 

Gravity, Primary Body.Potentiaffiile Default: JGM2. Options: [ CentralBody-based models, Other. See 

Comments ]. This field allows the user to define the source for the 
non-spherical gravity coefficients for a primary body. If a grav- 
ity file is located in the Primary Body’s potential path as defined 
in the startup file, you only need to specify the model name and 
not the entire path. For example, if the JGM2 coefficients file is 
contained in the directory defined in the startup file by the line 
EARTH JP OT_PATH, then you only need to specify the model 
name JGM2. If the model is not contained in the body’s poten- 
tial path, you must supply the entire path as well as the file name. 
If GMAT does not successfully find the file requested, it uses the 
default gravity model as defined in the startup file. From the GUI, 
only models for Earth appear if Earth is the active primary body. 
This is to avoid allowing the user to select a lunar potential model 
for the Earth. If the Other option is selected the user has the abil- 
ity of selecting a gravity model file on their local computer. Units: 
None. 

Gravity* PrimaryB ody.Degree Default: 4. Options: [ Integer >0 and < the maximum specified by 

the model, Order < Degree ]. This field allows the user to select the 
the degree, or number of zonal terms, in the non-spherical gravity 
model. Ex. Gravity .Earth. Degree = 2 tells GMAT to use only 
the J2 zonal term for the Earth. The value for Degree must be less 
than the maximum degree specified by the Model. Units: None. 

Gravity. PrimaryBody.Ordev Default: 4. Options: [ Integer >0 and < the maximum specified by 

the model, Order < Degree ]. This field allows the user to select 
the the order, or number of tesseral terms, in the non-spherical 
gravity model. Ex. Gravity.Earth. Order = 2 tells GMAT to use 
2 tesseral terms. Note: Order must be greater than or equal to 
Degree. Units: None. 

Drag Default: None. Options: [None, JachhiaRoberts, MSISE90, 

Exponential ]. The Drag field allows a user to specify a drag 
model. Currently, only one drag model can be chosen for a partic- 
ular propagator and only Earth models are available. Units: N/A. 
Note: This field will be deprecated in future versions of GMAT . 
Currently , the Drag field and the Drag. AtmosphereModel field 
must be set to the same value. 

Drag. AtmosphereModel Default: None. Options: [JachhiaRoberts, MSISE90, 

Exponential ]. The Drag. AtmosphereModel field allows a user 
to specify a drag model. Currently, only one drag model can be 
chosen for a particular propagator and only Earth models are avail- 
able. Units: N/A. 

Default: 150. Options: [ Real Number > 0 ]. The F107 field allows 
you to set the F 10.7 solar flux value used in computing atmospheric 
density. F 10.7 is the solar radiation at a wavelength of 10.7 cm. 
Units: W/m 2 /Hz 

Default: 150. Options: [ Real Number > 0 ]. The F107A field 
allows you to set the average F 10.7 value. F 10.7 is the average of 
jF*i(X 7 over one month. Units: W/m 2 /Hz 


Drag. FI 07 


Drag.F107A 
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Table 2.6: (Fields Associated with a Force Model.. .continued) 


Field 


Options and Description 


Drag . Magnet i c Index 


SRP 


PointMasses 


ErrorControl 


Defaults. Options: [ 0 < Real Number < 9 ]: The Magnet iclndex 
index Feld allows you to set the k p value for use in atmospheric 
density calculations. k p is a planetary 3-hour-average, geomagnetic 
index that measures magnetic effects of solar radiation. Units: 
None. 

Default: Off. Options: [ On, Off ]. The SRP field allows the user to 
include the force due to solar radiation pressure in the total sum 
of forces. Units: N/A. 

Default: None. Options [ Sun, Mercury, Venus, Earth, Luna, Mars, 
Jupiter, Saturn, Uranus, Neptune, Pluto ]. A PointMass is a 
planet or moon that is modelled by a point source located at its 
center of gravity. A PointMass body can be any planet or moon 
not included in the PrimaryBodies field. Units: N/A. 

Default: RSSStep. Options: [ RSSStep, RSSState, LaxgestState, 
Large st Step]: The ErrorControl field allows you to choose how 
a Propagator measures the error in an integration step. The algo- 
rithm selected in the ErrorControl field is used to determine the 
error in the current step, and this error is compared to the value 
set in the Accuracy field to determine if the step has an accept- 
able error or needs to be improved. All error measurements are 
relative error, however, the reference for the relative error changes 
depending upon the selection of ErrorControl. RSSState is the 
Root Sum Square (RSS) relative error measured with respect to 
the current step. RSSState is the (RSS) relative error measured 
with respect to the current state. Largest Step is the state vector 
component with the largest relative error measured with respect 
to the current step. Largest St ate is the state vector component 
with the largest relative error measured with respect to the current 
state. For a more detailed discussion see the GMAT Mathematical 
Specification. Units: N/A. 


Table 2.7: Fields Associated with an Integrator 
Field Options and Description 


Fields associated with All Integrators 

Type Default: RungeKutta89. Options: [ RungeKutta89, RungeKutta68, 

RungeKutta56, PrinceDormand45, PrinceDormand78, BulirschStoer, 
AdamsBashforthMoulton ]: The Type field is used to set the type of 

numerical integrator. Units: N/A. 
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Table 2.7: Fields Associated with an Integrator.. ..(continued) 


Field 

Options and Description 

InitialStepSize 

Default: 60 (sec). Options: [ Real Number ]. The InitialStepSize is 

the size of the first attempted step by the integrator. If the step defined by 
InitialStepSize does not satisfy Accuracy, the integrator adapts the step 
according an algorithm defined in the mathematical specifications document to 
find an acceptable first step that meets the user’s requested Accuracy. Units: 
sec. 

Accuracy 

Default: le-11. Options: [ Real Number > 0 ]. The Accuracy field is used 

to set the desired accuracy for an integration step. Units: N/A. When you 
set a value for Accuracy, GMAT uses the method selected in ErrorControl 
field on the Force Model, to determine a metric of the acctiracy. For each step, 
the integrator ensures that the accuracy, as calculate using the method define 
by ErrorControl, is less than the limit defined by Accuracy. If an integrator 
exceeds MaxStep At tempts trying to meet the requested accuracy, and error 
message is thrown and propagation stops. 

Min Step 

Default: .001 (sec). Options: [ Real Number > 0, MinStep < MaxStep ]. The 
MinSt ep field is used to set the minimum allowable step size. Units: sec. 

MaxStep 

Default: 2700.0 (sec.). Options: [ Real Number > 0, MinStep < MaxStep ]. 
The MaxStep field is used to set the maximum allowable step size. Units: sec. 

Max St ep At tempt s 

Default: 50. Options: [ Integer > 0], The MaxStep At tempts field allows the 

user to set the number of attempts the integrator takes to meet the tolerance 
defined by Accuracy. Units: None. 


Fields associated only with Adams-Bashforth-Moulton Integrator 

Minlnt egr at i onErr or 

Default: l.Oe-13. Options: [ Real Number > 0, MinlntegrationError < 
NomlntegrationError < Accuracy ]: The MinlntegrationError field is used 
by the ABM integrator (and other predictor-corrector integrators when imple- 
mented) as the desired integration error to be obtained when the step size is 
changed. Predictor-Corrector integrators adapt step size when the obtained in- 
tegration error falls outside of the range of acceptable steps, as determined by 
the bounds set by the MinlntegrationError and Accuracy fields. The integral 
tor then applies an internal calculation to recompute the step size, attempting 
to hit the NomlntegrationError, and restarts the integrator. Units: N/A. 

N omlrit e gr at i o nErr or 

Default: 1.0e-ll. Options: [ Real Number > 0, MinlntegrationError < 
NomlntegrationError < Accuracy ]: The Nomint egrationErr or field is used 
by the ABM integrator (and other predictor-corrector integrators when imple- 
mented) as the desired integration error to be obtained when the step size is 
changed. Predictor-Corrector integrators adapt step size when the obtained in- 
tegration error falls outside of the range of acceptable steps, as determined by 
the bounds set by the MinlntegrationError and Accuracy fields. The integral 
tor then applies an internal calculation to recompute the step size, attempting 
to hit the NomlntegrationError, and restarts the integrator. Units: N/A. 
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2 . 3 . 


MANEUVERS 
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Table 2.7: Fields Associated with an Integrator... . (continued) 


Field 


Options and Description 


Script Examples 


Create ForceModel MyProp^ForceModel ; 

GMAT My Prop_For ceModel. CentralBody - Earth; 

GMAT MyProp_For ceModel .PrimaryBodies = {Earth}; 

GMAT MyProp^ForceModel .PointMasses * {Sun, Luna}; 

GMAT My Prop^F or ceModel. Drag = None; 

GMAT MyProp _For ceModel. SRP = Off; 

GMAT MyPr op_For ceModel, ErrorControl = RSSStep; 

GMAT MyPr op_F or ceModel. Gravity .Earth. Degree ~ 4; 

GMAT My Prop.For ceModel. Gravity. Earth. Order - 4; 

GMAT MyPr op_For ceModel. Gravity. Earth. PotentialFile =/JGM2v; 

Create Propagator MyPr op; 

GMAT MyProp.FM = My Prop_For ceModel; 

GMAT MyProp.Type « RungeKutta89 ; 

GMAT MyProp.InitialStepSize - 60; 

GMAT MyProp. Accuracy = 9 ,999999999999999e-0i2; 

GMAT My Prop. MinSt ep ~ 0.001; 

GMAT MyProp.MaxStep = 2700; 

GMAT MyProp. MaxStep At tempts =50; 


Maneuvers 

Table 2.8: Fields Associated with an Impulsive Burn 

Field 

Options and Description 

Origin 

Default: Earth . Options: [Any celestial body]: Together the Origin and 
Axes fields describe the coordinate system in which a maneuver is applied. 
The Origin field determines the origin of the maneuver coordinate system. 
The ability to define the coordinate system locally avoids having to create 
many coordinate systems, associated with specific spacecraft, in order to 
perform finite maneuvers for multiple spacecraft. Units: N/A. 

Axes 

Default: VNB . Options: [VNB,MJ2000Eq]: The Axes field, together with 
the Origin field, describe the coordinate system in which an impulsive 
maneuver is applied. If VNB is chosen for Axes, a local coordinate system is 
created such that the x-axis points in the velocity direction of the spacecraft, 
with respect to the point defined by Origin, the y-axis points in the normal 
direction of the spacecraft with respect to Origin, and the z-axis completes 
the right-handed set. Units: N/A. 

VectorFormat 

Default: Cartesian . Options: [Cartesian, Spherical]: The 

VectorFormat field allows the user to define the format of the maneuver 
vector. Units: N/A. 
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Table 2.8: (continued) 


Field 

Options and Description 

Element 1 

Default: 0. Options: [Real Number]: The Element 1 field allows the user 
to define the first element of the impulsive maneuver vector. Element 1 is 
x if VectorFormat is Cartesian. Elementl is the magnitude of the burn 
if VectorFormat is spherical. Units: krn/sec. 

Element 2 

Default: 0. Options: [Real Number]: The Element 2 field allows the user 
to define the second element of the impulsive maneuver vector. Element2 
is y if VectorFormat is Cartesian. Units: km/sec. 

Element3 

Default: 0. Options: ]Real Number]: The Element 3 field allows the user 
to define the second element of the impulsive maneuver vector. Element 3 
is 2 if VectorFormat is Cartesian, Units: km/sec. 

Table 2.9: Fields Associated with a Finite Burn 

Field 

Options and Description 

Origin 

Default: Earth . Options: [Any celestial body, libration point, or barycen- 
ter]: Together the Origin and Axes fields describe the coordinate system 
in which a maneuver is applied. The Origin field determines the origin 
of the maneuver coordinate system. The ability to define the coordinate 
system locally avoids having to create many coordinate systems, associated 
with specific spacecraft, in order to perform finite maneuvers for multiple 
spacecraft. Units: N/A. 

Axes 

Default: VNB . Options: [VNB, MJ2000Eq ]: The Axes field, together with 
the Origin field, describe the coordinate system in which a finite maneuver 
is applied. If VNB is chosen for Axes, a local coordinate system is created 
such that the x-axis points in the velocity direction of the spacecraft, with 
respect to the point defined by Origin, the y-axis points in the normal 
direction of the spacecraft with respect to Origin, and the z-axis completes 
the right-handed set. Units: N/A. 

Thrusters 

Default: No Default. Options: [Any thruster created by user]: The 

Thrusters field allows the selection of which thrusters to use when 
applying a finite maneuver. The user can select more than one 

thruster, from the list of thrusters previously created, by including all 
thrusters in curly braces. An example is MyFiniteBurn. Thrusters * 
{Thrust erl , Thrust er2,Thruster3}. Units: N/A. 

BurnS caleFact or 

Default: 1.0 . Options: [Real Number]: The BurnS caleFact or is used 
to scale the total acceleration before adding the acceleration due to a fi- 
nite burn into the sum of the accelerations of a spacecraft. The scaling is 
performed by taking the sum of the accelerations applied by all thrusters 
specified under the Thrusters field, and multiplying the total thrust by 
BurnScaleFactor. Units: None. 


2.4 Solver Fields 
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Table 2.10: Fields Associated with the froiucon Solver 
Field Options and Description 


DiffMax 

Change 


Dif fMin 
Change 


Default: 0.1 . Options: [Real Number > 0]: The DiffMaxChange parameter sets the upper 
limit on the perturbation used in MATLAB ’s finite differencing algorithm. For fmincon, 
you don’t specify a single perturbation value, but rather give MATLAB a range, and it uses 
an adaptive algorithm that attempts to find the optimal perturbation. Units: N/A . 

Default: le-8 . Options: [Real Number > 0]: The Dif fMinChange parameter sets the lower 
limit on the perturbation used in MATLAB ’s finite differencing algorithm. For fmincon, 
you don’t specify a single perturbation value, but rather give MATLAB a range, and it uses 
an adaptive algorithm that attempts to find the optimal perturbatin. Units: N /A . 


MaxFunEvals Default: 1000. Options: [Integer > 0]: The MaxFunEvals parameter allows the user to set 
the maximum number of cost function evaluations in an attempt to find an optimal solution. 
This is equivalent to setting the maximum number of passes through an optimization loop 
in a GMAT script. If a solution is not found before the maximum function evaluations, 
fmincon outputs an ExitFlag of zero, and GMAT continues. Units: N/A. 


Maxlter Default: 400. Options: [Integer > 0]: The Maxlter parameter allows the user to set the 
maximum allowable number of optimizer iterations. Depending upon the nature of the 
problem, and whether gradients are provided, it may take many function evaluations for 
each optimizer iteration. The Maxlter parameter allows the user to control the maximum 
function evaluations, and maximum iterations independently. Units: N/A . 


TolX Default: le-4. Options: [Real Number > 0]: The TolX parameter is the termination toler- 

ance on the vector of independent variables, and is used only if the user sets a value. Units: 
N/A. 


TolFun Default: le-4. Options: [Real Number > 0]: The TolFun parameter is the convergence 

tolerance on the cost function value. Units: N/A . 

TolCon Default: le-4 . Options: [Real Number > 0]: The TolCon parameter is the convergence 

tolerance on the constraint functions. Units: N/A . 

Derivative Default: off. Options: [on, off]: If the Deri vat i veChe ck option is set to on, then fmincon 

Check will calculate the gradients of the cost and constraints using finite differncing, and compare 

the values to the values calculated analytically. Units: N /A . 


Diagnostics Default: off. Options: [on, off]: The Diagnostics parameter tells fmincon to output 
general information on the problem by writing diagnostic information to the MATLAB 
prompt. The diagnostic information contains the number of independent variables, the 
number and types of constraints, the sources for derivatives and other information. Units: 
N/A . 

Display Default: iter. Options: [ off, on, iter, notify, final]: The Display parameter allows the 

user to select between several different options that displays information at the MATLAB 
prompt that indicates the progress of the optimization process. Units: N /A . 

GradObj Default: off. Options: [on, off]: The GradObj parameter allows the user to tell fmincon 

to use finite differencing to calculate the cost function derivative, or to use the cost function 
derivative provided by the user. Units: N/A . 
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Table 2.10: (Fields Associated with the fmincon 

Solver. . . .continued) 


F ield Options and Description 

GradC on str Default: offrOptions: [on, off}: The GradConstr parameter allows the user to tell fmin- 

con to use finite differencing to calculate the constraint function derivatives, or to use the 
constraint function derivatives provided by the user. Units: N/A. 


Table 2.11: Fields Associated with, a Differential (Corrector 


Field 

Maximumlterations 


ShowProgress 


EeportStyle 


TargeterTextFile 


Options and Description 

Default: 25. Options: [Integer > 0]: The Maximum Iterations field allows the 
user to define the maximum number of iterations taken in attempt to find a 
solution. Units: N/A. 

Default: true. Options: [true, false]: When the ShowProgress field is set to 
true, then data illustrating the progress of the differential correction process 
are written to the status bar. The status bar is updated with information on 
perturbation and iteration passes. . Units: N/A. 

Default: Normal . Options: [Normal, Concise, Verbose, Debug]: The 

ReportStyle field allows the user to control the amount and type of infor- 
mation written to TargeterTextFile. Units: N/A. 

Default: Diff erentialCorrectorDUAame. Options: [Filename consistent 

with OS]: The TargeterTextFile field allows the user to specify the path and 
file name for the targeter report. Units: N/A. 


UseCentralDif f erences Default: false Options: [true, false]: The UseCentralDif ferences field 

allows the user to choose between one-sided and central differencing for deter- 
mining the Jacobian matrix. If UseCentralDif ferences is set to false, then 
one-sided differencing is used, if UseCentralDif ferences is set to true, then 
central differencing is used. Units: N/A. 


2.5 Plots and Reports 


Table 2.12: Fields Associated with OpenGL Plots 


Field 


Options and Description 


Fields associated with Plot Options 

ShowPlot Default: true. Options: [ true, false]: The ShowPlot field allows the user to 

turn off a plot for a particular run, without deleting the plot object, or removing 
it from the script. If you select true, then the plot will be shown. If yon select 
false, then the plot will not be shown. Units: N/A. 
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2.5 . PLOTS AND REPORTS 


Table 2.12: (Fields Associated with OpenGL Plots.... continued) 


Field 

Options and Description 

DataCollectFrequency 

Default: 1. Options: [ Integer > 1]: The DataCollectFrequency field allows 
the user to define how data is collected for plotting. It is often inefficient to draw 
every ephemeris point associated with a trajectory. Often, drawing a smaller 
subset of the data still results in smooth trajectory plots, while executing more 
quickly. The DataCollect Frequency is an integer that represents how often to 
collect data and store for plotting. If DataCollect Frequency is 10, then Data 
is collected every ten integration steps. Units: Integration Steps 

UpdatePlotFrequency 

Default: 50. Options: [Integer > 1]: The UpdatePlotFrequency field al- 
lows the user to specify how often to update an OpenGL plot is updated 
with new data collected during the process of propagating spacecraft and run- 
ning a mission. Data is collected for a plot according the value defined by 
DataCollect Frequency. An OpenGL plot is updated with the new data, ac- 
cording to the value set in UpdatePlotFrequency. If UpdatePlotFrequency is 
set to 10, then the plot is updated with new data every ten integration steps. 
Units: Integration Steps. 

NumPointsToRedraw 

Default: 0. Options: [Integer > 0]: When NumPointsToRedraw is set to zero, 
all ephemeris points are drawn. When NumPointsToRedraw is set to a positive 
integer, say 10 for example, only the last 10 collected data points are drawn. See 
DataCollect Frequency for explanation of how data is collected for an OpenGL 
plot. Units: Integration Steps. 


Fields associated with Drawing Options 

WireFrame 

Default: Off . Options: [ On, Off ]: When the WireFrame field is set to On, 
celestial bodies are drawn using a wireframe model. When the WireFrame field 
is set to Off, then celestial bodies are drawn using a full map. Units: N/A. 

Solver Iterations 

Default: Off. Options: [On, Off]: The Solver Iterations field determines 
whether or not perturbed trajectories are plotted during a solver (Targeter, 
Optimize) sequence. When Solver Iterations is set to On, solver iterations 
are shown on the plot. When Solverlterations is Off, the solver iterations 
are not shown on the plot. Units: N/A. 

EclipticPlane 

Default: Off. Options: [On, Off , Note: Only allowed for OpenGL plots with 
Coordinate Systems that use the MJ2000Eq axis system]: The EclipticPlane 
field allows the user to tell GMAT to draw a grid representing the ecliptic plane 
in an OpenGL plot. Note, the ecliptic plane can currently only be drawn for 
plots whose coordinate system uses the MJ2000Eq axis system. Units: N/A . 

XYPlane 

Default: On. Options: [On, Off]: The XYPlane flag allows the user to tell GMAT 
to draw a grid representing the XY-plane of the coordinate system selected 
under the CoordinateSystem field of the OpenGL plot. Units: N/A . 

Axes 

Default: On. Options: [On, Off]: The Axis flag allows the user to tell GMAT to 
draw the Cartesian axis system associated with the coordinate system selected 
under the CoordinateSystem field of an OpenGL plot. Units: N/A . 

Grid 

Default: On. Options: [On, Off]: The Grid flag allows the user to tell GMAT to 
draw a grid representing the longitude and latitude lines celestial bodies added 
to an OpenGL plot. Units: N/A . 
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Table 2.12: (Fields Associated with OpenGL Plots.... continued) 


Field Options and Description 

EarthSunLines Default: On. Options: [On, Off]: The EarthSunLines allows the user to tell 

GMAT to draw a line that starts at the center of Earth and points towards the 
Sun. Units: N/A . 


Fields Associated with View Definition 


CoordinateSystem Default: EarthMJ2000Eq. Options: [ Any default or user defined coordinate 

system]: The CoordinateSystem field on an OpenGL plot allows the user to 
select which coordinate system to use to draw the plot data. A coordinate 
system is defined as an origin and an axis system, and the CoordinateSystem 
field allows the user to determine the origin and axis system of an OpenGL plot. 
See the CoordinateSystem object fields for information of defining different 
types of coordinate systems. Units: N/A. 


Add Default: Default SC, Earth. Options: [SpacecraftName CelestialBodyName 

LibrationPointName BarycenterName]: The Add suhfield adds a space- 

craft .celestial body, libration pointer barycenter to a plot. When creating a 
plot the Earth is added as a default body and may be removed by using the Re- 
move command. The user can add a spacecraft, celestial body, libration point, 
or barycenter to a plot by using the name used to create the object. The GUPs 
Selected field is the equivalent of the script’s Add field. In the event of no Add 
command or no objects in the Selected field, GMAT should run without the 
OpenGL plot and a warning message displayed in the message window. The 
following warning message is sufficient: OpenGL plot will be turned off. 
Mo object has been selected for plotting. Units: N/A. 

Remove Default: No Default. Options: [Any object included in the Add list ]: The Re- 

move subfield removes a spacecraft, celestial body, libration point, or barycenter 
from a plot. The user can remove any object that has been added to a plot by 
using the name used to add the object. Units: N/A. 

Viewpoint Reference Default: Earth. Options: [SpacecraftName CelestialBodyName Libration- 
PointName BarycenterName, or a 3- vector of numerical values ]: The 

ViewPointReference field is an optional field that allows the user to 
change the reference point from which Viewpoint Vector is measured. 
ViewPointReference defaults to the origin of the coordinate system for the 
plot. A ViewPointReference can be any spacecraft, celestial body, libration 
point, or barycenter. Units: N/A. 


ViewPointVector Default: [0 0 30000]. Options: [ SpacecraftName CelestialBodyName Libration- 

PointName BarycenterName, or a 3-vector of numerical values ]: The product 
of ViewS caleFact or and ViewPointVector field determines the view point lo- 
cation with respect to ViewPointReference. ViewPointVector can be a vec- 
tor, or any of the following objects: spacecraft, celestial body, libration point, or 
barycenter. The location of the Viewpoint in three-space is defined as the 
vector addition of ViewPointReference, and the vector defined by product of 
ViewS caleFact or and ViewPointVector in the coordinate system chosen by 
the user. Units: km or N/A, 
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Table 2.12: (Fields Associated with OpenGL Plots.... continued) 

Field Options and Des cription 

ViewDirection Default: Earth. Options: [ Spacecraft Name CelestialBodyName Libra- 

tionPointName BarycenterName, or a 3- vector of numerical values ]: The 
ViewDirection field allows the user to select the direction of view in an OpenGL 
plot. The user can specify the view direction by choosing an object to point 
at such as a spacecraft, celestial body, libration point, or barycenter. Alternar- 
tively, the user can specify a vector of the form [xyzj. If the user specification 
of ViewDirection, ViewPointReference, and ViewPointVector, results in a 
zero vector, GMAT uses [0 0 10000] for ViewDirection. Units: km or N/A. 

ViewS caleFact or Default: 1. Options [ Real Number > 0]: The ViewScaleFactor field 

scales ViewPointVector before adding it to ViewPointReference. The 
ViewScaleFactor allows the user to hack away from an object to fit in the 
field of view. Units: None. 


Fields Associated with View Up Definition 

Default: EarthMJ2000Eq. Options: [Any default or user defined coordinate 
system]: The ViewUpCoordinateSystem and ViewUpAxis fields are used to de- 
termine which direction appears as up in an OpenGL plot and together with the 
fields associated the the View Direction, uniquely define the view. The fields 
associated with the View Definition allow the user to define the point of view 
in 3-space, and the direction of the line of sight. However, this information 
alone is not enough to uniquely define the view. We also must provide how 
the view is oriented about the line of sight. This is accomplished by defining 
what direction should appear as the up direction in the plot and is config- 
ured using the ViewUpCoordinateSystem field and the ViewUpAxis field. The 
ViewUpCoordinateSystem allows the user to select a coordinate system to de- 
fine the up direction. Most of the time this system will be the same as the 
coordinate system chosen under the CoordinateSystem field. Units: N/A. 

ViewUpAxis Default: Z. Options: [X, -X, Y, ~Y, Z, -Z]: The ViewUpAxis allows the user to 

define which axis of the ViewUpCoordinateSystem that will appear as the up di- 
rection in an OpenGL plot. See the comments under ViewUpCoordinateSystem 
for more details of fields used to determine the up direction in an OpenGL plot. 
Units: N/A. 


Fields Associated with Field of View 

UselnitialView Default: On. Options: [On, Off]: The UselnitialView field allows the user 

to control the view of an OpenGL plot between multiple runs of a mission 
sequence. The first time a specific OpenGL plot is created, GMAT will auto- 
matically use the view as defined by the fields associated with View Definition, 
View Up Direction, and Field of View. However, if the user changes the view 
using the mouse, GMAT will retain this view upon rerunning the mission if 
UselnitialView is set to false. If UselnitialView is set to true, the view 
for an OpenGL plot will be returned to the view defined by the initial settings. 
Units: N/A. 


Vie wUpCoordinat e 
System 
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Table 2.12: (Fields Associated with OpeoGI. Plots.. ..continued) 


Field 

Options and Description 

PerspectiveMode 

Def atilt: Off. Options: [On, Off]: The PerspectiveMode field allows to 

user to toggle between the Orthogonal or Perspective projections. When 
PerspectiveMode is set to true, the Perspective projection is used. When 
PerspectiveMode is set to false, the Orthogonal projection is used. Units: 
N/A. 

UseFixedF ov 

Default: Off. Options: [On, Off]: Units: N/A. 

FixedFovAngle 

Default: 45. Options: [ Real Number > 1]: Units: Degrees. 

Table 2.13: Fields Associated with Report Files 

Field 

Options and Description 

FileName 

Default: /RunReports/ReportFilel .txt. Options: [Valid File Path and 

Name]: The Filename field allows the user to define the file path and file 
name for a report. Units: None. 

Precision 

Default: 16. Options: [Integer > 0]: The Precision field allows the user to set 
the precision of the variable written to a report. Units: Same as variable being 
reported. 

Add 

Default: N/A. Options: [Any user-defined parameter. Ex. Variables, Ar- 
rays, S/C parameters]: The Add field alkrws a user to add user-defined vari- 
ables to a report file. To add multiple user-defined variables, enclose the 
variables with curly brackets. Ex. My Report Name. Add = {Sat.X, Sat.Y, 
Varl, Array (1,1)}; The GUI’s Selected field is the equivalent of the script’s 
Add field. In the event of no Add command or no objects in the Selected 
field, GMAT should rim without the Report output and a warning message 
displayed in the message window. The following warning message is suffi- 
cient: Report plot will be turned off. No object has been selected 
for reporting. Units: N/A. 

WriteReport 

Default: On . Options: [On, Off]: The WriteReport field specifies whether to 
write data to the report FileName. Units: N/A. 

WriteHeaders 

Default: On . Options: [On, Off]: The WriteHeaders field specifies whether to 
include headers that describe the variables in a report. Units: N/A. 

Lef tJustify 

Default: On. Options: [On, Off]: When the Lef tJustify field is set to On, then 
the data is left justified and appears at the left most side of the column. If the 
Lef tJustify field is set to Off, then the data is centered in the column. Units: 
N/A. 

ZeroFill 

Default: On. Options: [On, Off]: Units: N/A . 

ColumnWidth 

Default: 20. Options: [ Integer > 0]: The ColumnWidth field is used to define 
the width of the data columns in a report file. The value for ColumnWidth is 
applied to all columns of data. For example, if ColumnWidth is set to 20, then 
each data column will be 20 white-spaces wide. Units: Characters. 
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2.6. SOLAR SYSTEM y CELESTIAL BODIES AND OTHER SPACE POINTS" '" 

Table 2,13: Fields Associated with Report Files.... (continued) 


Field 

Options and Description 

Solverlterations 

Default: Off. Options: [On, Off]: The Solverlterations field deter- 

mines whether or not data associated with perturbed trajectories during 
a solver (Targeter, Optimize) sequence is written to a report file. When 
Solverlterations is set to On, solver iterations are written. to the report file. 
When Solverlterations is Off, the solver iterations are not written to the 
report file. Units: N/A. 

Table 2.14: Fields Associated with XY-Plots 

Field 

Options and Description 

IndVar 

Default: D ef ault SC . A IMod Juli an. Options: [Any user variable, array element, 
or spacecraft parameter]: The IndVar field allows the user to define the indepen- 
dent variable for an xy-plot. Only one variable can be defined as an independent 
variable. For example, the line MyXYPlot . IndVar = Default SC . AlModJulian 
sets the independent variable to be the epoch of Default SC in the A! time 
system and modified Julian format. Units: N/A. 

Add 

Default: Def aultSC . Earth.MJ2000Eq . X. Options: [Any user variable, array ele- 
ment, or spacecraft parameter]:: The Add field allows the user to add dependent 
variables to an xy-plot. All dependent variables are plotted on the y-axis vs the 
independent variable defined by IndVar. To define multiple dependent vari- 
ables, they should be included in curly braces. For example, MyXYPlot . Add 
= {Def aultSC .EarthMJ2000Eq.Y , Def aultSC .EarthMJ2000Eq. 2] }: . The 
GUI’s Selected field is the equivalent of the script’s Add field. In the event 
of no Add command or no objects in the Selected field, GMAT should run 
without the XYPlot and a warning message displayed in the message window. 
The following warning message is sufficient: XYPlot will be turned off. 
No object has been selected for plotting. Units: N/A. 

Grid 

Default: On . Options: [ On, Off ]: When the Grid field is set to On, then a grid 
is drawn on an xy-plot. When the Grid field is set to Off, then a grid is not 
drawn. Units: N/A. 

Solverlterations 

Default: Off. Options: [On, Off]: The Solverlterations field determines 
whether or not perturbed trajectories are plotted during a solver (Targeter, 
Optimize) sequence. When Solverlterations is set to On, solver iterations 
are shown on the plot. When Solverlterations is set to Off, solver iterations 
are not shown on the plot. Units: N/A. 

ShowPlot 

Default: true. Options: [ true, false]: The ShowPlot field allows the user to 
turn off a plot for a particular run, without deleting the plot object, or removing 
it from the script. If you select true, then the plot will he shown. If you select 
false, then the plot will not be shown. Units: N/A. 


2.6 Solar System, Celestial Bodies and other Space Points 



CHAPTER r' OBJECTS AND RESOURCES 


Table 2.15: Fields Associated with the Solax System 


Field 

Options and Description 

EphemerisSource 

Default: DE405. Options: [DE405, DE200, SLP, Analytic]: The 

EphemerisSource field allows the user to select the source used for planetary 
ephenierides. The source is used globally whenever planetary ephemeris infor- 
mation is required. Units: None. 

Ephemeris 
Update Interval 

Default: 0. Options: [ Real Number > 0]. The EphemerisUpdate Interval is 
used to set how often planetary positions are updated when calculating accel- 
erations during propagation. For low-Earth orbits, EphemerisUpdate Interval 
can be set to around 60 for faster numerical integration with little ef- 
fect on the accuracy of the propagation. For deep space propagation, 
EphemerisUpdate Interval should be set to zero. Units: sec. 

UseTTForEphemeris 

Default: false. Options: [ true, false]: GMAT uses time in the TDB system 
as the default time system in the JPL ephemeris files. However, often it is 
possible to use time in the TT time system, without significant difference in 
propagation accuracy. (TT and TDB are within 1 millisecond of each other). 
The advantage to using TT is that it avoids the transformation from TT to TDB 
and therefore orbit propagation will execute faster. The UseTTForEphemeris 
field allows the user to choose between the default of TDB in the ephemeris files 
(UseTTForEphemeris==false), or TT in the ephemeris files (UseTTForEphemeris 
= true). Units: N/A. 

EphemerisFile 

Default: Same as startup file. Options: [ File path and file name consistent 
with operating system ]: The EphemerisFile field allows the user to specify 
the location and name of the file for each type of ephemeris GMAT supports. 
For example, if Ephemeris is set to DE405, you can set the path for a DE405 
file using Solar System. EphemerisFile = c :/MyPath/MyDE405 .f ile. Units: 
N/A. 

AnalyticModel 

Default: LowFidelity. Options: [ LowFidelity]: Units: N/A. 

Table 2.16: Fields Associated with a Libration Paint 

Field 

Options and Description 

Primary 

Default: Sun. Options: [ Sun, Mercury, Venus, Earth, Luna, Mars, Jupiter, 
Saturn, Uranus, Neptune, Pluto , or any Barycenter. ( The Primary and Sec- 
ondary bodies cannot be the same )]: The Primary field tells GMAT which body 
to consider the primary body in the calculation of the location of a libration 
point. Units: N/A. 

Secondary 

Default: Earth. Options: [ Sun, Mercury, Venus, Earth, Luna, Mars, Jupiter, 
Saturn, Uranus, Neptune, Pluto , or any Barycenter. ( The Primary and 
Secondary bodies cannot be the same )]: The Secondary field tells GMAT 
which body to consider the secondary body in the calculation of the location 
of a libration point. Units: N/A. 

Point 

Default: LI. Options: [LI, L2, L3, L4, L5]: The Point field specifies which 
libration point the object corresponds to. Units: N/A. 
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. Table 2.17: Fiehls Associated with a B ary Center 


Field 

Options and Description 

BodyNames 

Default: {Earth, Luna}. Options: [ Sun, Mercury, Venus, Earth, Luna, Mars, 
Jupiter, Saturn, Uranus, Neptune, Pluto . (At least one body must be se- 
lected!)]: The BodyNames field is list that contains the bodies used to define 
a barycenter. In a script, the list must be surrounded by curly braces i.e. 
BaryCenterName .BodyNames = {Earth, Luna} ; Units: N/A. 

Table 2.18: Fields Associated with Celestial Bodies 

Field 

Options and Description 


Fields Associated with All Celestial Bodies. ( Using Default Values 
for Earth as an Example) 

Mu 

Default: 398600.4414. Options: [Real Number > 0]: The Mu field allows the 
user to define the gravitational paramter of a celestial body. Units: km 3 /sec 2 . 

Equatorial Radius 

Default: 6378.1363. Options: [Real Number > 0]: The Equator ialRadius field 
allows the user to define the equatorial radius of a celestial body. Units: km. 

Flattening 

Default: 0.00335270. Options: [Real Number] : The Flattening field allows 
the user to define the mass of a celestial body. Units: None. 

InitialEpoch 

Default: 21544.500371. Options: [Real Number ]: The InitialEpoch field 
allows the user to define the initial epoch, in A1 Modified Julian Date, for a 
celestial body. The initial epoch is only used when the user selects Analytic 
for the Ephemeris field on the solar system. In this case, GMAT solves Kepler’s 
problem to determine the position and velocity of a celestial body, using the 
initial epoch and state information described below. Units: A 1 Mod Julian. 

SMA 

Default: 149653978.978377. Options: [Real Number ^ 0]: The SMA field allows 
the user to define the semimajor axis of a celestial body’s orbit about its central 
body. (Only used when the user selects Analytic for the Ephemeris field on 
the Solar System.) Units: km. 

ECC 

Default: 0.017046. Options: [Real Number > 0]: The ECC field allows the 
user to define the eccentricity of a celestial body’s orbit about its central body. 
(Only used when the user selects Analytic for the Ephemeris field on the Solar 
System.) Units: None. 

INC 

Default: 23,439034. Options: [Real Number]: The INC field allows the user to 
define the inclination of a celestial body’s orbit about its central body, in the 
FK5 coordinate system. (Only used when the user selects Analytic for the 
Ephemeris field on the Solar System.) Units: deg. 

RAAN 

Default: 0.000186. Options: [Real Number]: The RAAN field allows the user 
to define the right ascension of the ascending node of a celestial body’s orbit 
about its central body, in the FK5 coordinate system. (Only used when the 
user selects Analytic for the Ephemeris field on the Solar System.) Units: deg. 
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Table 2.18: (Fields Associated with Celestial Bodies... continued) 


Field 

Options and Description 

AOP 

Default: 101.741639. Options: [Real Number]: The AOP field allows the user 
to define the argument of periapsis of a celestial body’s orbit about its central 
body, in the FK5 coordinate system. (Only used when the user selects Analyti c 
for the Ephemeris field on the Solar System.) Units: deg. 

TA 

Default: 358.127085. Options: [Real Number]: The TA field allows the user 
to define the true anomaly of a celestial body’s orbit about its central body. 
(Only used when the user selects Analytic for the Ephemeris field on the Solar 
System.) Units: deg. 


Special Fields Associated with Earth 

Nut at i ouUpdat e 
Interval 

Default: 60. Options: [Real Number > 0]: The NutationUpdatelnterval 
field, on the Earth Celestial Body, determines how often GMAT updates the 
Nutation matrix used in FK5 reduction. If NutationUpdatelnterval is set to 
zero, the Nutation is updated every time a request is made to calculate the 
orientation of the Earth. If NutationUpdatelnterval is set to a real number 
greater than zero, then GMAT only updates the Nutation matrix if the number 
of seconds defined by NutationUpdatelnterval have elapsed since the last 
request for the Earth’s orientation data. Units: sec. 


Special Fields Associated with Luna 

RotationData Source 

Default: DE405. Options: [DE405, IAU2002]: The RotationDataSource, on 
the Luna Celestial Body, determines what source GMAT uses to obtain data 
describing the orientation of the moon with respect to the FK5 system. The 
RotationDataSource field is only used for lunar orientation data when calculat- 
ing moon-based coordinate systems with the axes types of Fixed and Equator. 
Units: N/A 

Table 2.19: Fields Associated with a Coordinate System 

Field 

Options and Description 

Origin 

Default: Earth. Options: [ Any celestial body, barycenter, libration point, or 
spacecraft]: The Origin field allows the user to select the origin of a coordinate 
system. Units: N/A . 

Axes 

Default: MJ2000Eq . Options: [ MJ2000Eq, MJ2000Ec, EarthFixed, BodyFixed, 
TOEEq, TGEEc, MQEEq, MQEEc, TODEq, TODEc, MODEq, MODEc, ObjectRef erenced, 
Equator, BodyFixed, BodyInertial,GSE, GSM ]: Units: N/A. 

Primary 

Default: Earth . Options: [Any celestial body, barycenter, libration point, or 
spacecraft, except the object chosen as in the Secondary field ]: The Primary 
field is only active when Axes is set to ObjectRef erenced. Otherwise, GMAT 
ignores the Primary field. Units: N/A . 
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Table 2.19: (Fields Associated with a Coordinate Sys- 

tem... continued) 


Field 

Options and Description 

Secondary 

Default: Luna . Options: [Any celestial body, barycenter, libration point, or 
spacecraft, except the object chosen as in the Primary field]: The Secondary 
field is only active when Axes is set to ObjectReferenced. Otherwise, GMAT 
ignores the Secondary field. Units: N/A . 

Epoch 

Default: 21545.0. Options: [ Real Number > 0]: The Epoch field is only active 
if the Axes field is defined by an epoch referenced axis system: MQEEq, MOEEc, 
TOEEq, TOEEc. Units: Days . 

XAxis 

Default: R. Options: [ R, -R, V, -V, N, -N]: The X field is only active if the Axes 
field is set to ObjectReferenced. Otherwise, GMAT ignores the X field. Units: 
N/A. 

YAxis 

Default: No Default. Options: [R, -R, V, -V, M, -N]: The Y field is only active 
if the Axes field is set to ObjectReferenced. Otherwise, GMAT ignores the Y 
field. Units: N/A. 

Z Ax is 

Default: N . Options: [R, -R, V, -V, N, -N]: The Z field is only active if the Axes 
field is set to ObjectReferenced. Otherwise, GMAT ignores the Z field. Units: 
N/A. 

Update Interval 

Default: 60. Options: [Real Number > 0]: Units: seconds. 

Table 2.20: Fields Associated with MATLAB Functions 

Field 

Options and Description 

FunctionPath 

Default: \matlab\work. Options: [Any valid path for Operating System]: 
Units: N/A. 
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Chapter 3 


Commands and Events 

3.1 Propagation 


Table 3.1: Propagate Command 


ScriptSyntax . 

Propagate Mode BackProp PropagatorName (SatListi,{StopCondListl}) ... 
B&ctePxopPropagatorName (SatListN, {StopCondListN}) 

Option 

Option Description 

BackProp 

Default: None. Options: [ Backwards or None ]: The BackProp option allows the 
nser to set the flag to enable or disable backwards propagation for all spacecraft in 
the the SatListN option. The Backward Propagation GUI check box field stores 
all the data in BackProp. A check indicates backward propagation is enabled and 
no check indicates forward propagation. In the script, BackProp can he the word 
Backwards for backward propagation or blank for forward propagation. Units: N/A. 

Mode 

Default: None. Options: [ Synchronized or None ]: The Mode option allows the 
nser to set the propagation mode for the propagator that will affect all of the 
spacecraft added to the SatListN option. For example, if synchronized is selected, 
all spacecraft are propagated at the same step size. The Propagate Mode GUI field 
stores all the data in Mode. In the script, Mode is left blank for the None option 
and the text of the other options available is used for their respective modes. Units: 
N/A. 

PropagatorN ame 

Default: DefaultProp. Options: [ Defa\ilt propagator or any user-defined propaga- 
tor ]: The PropagatorName option allows the user to select a user defined propagator 
to use in spacecraft and/or formation propagation. The Propagator GUI field stores 
all the data in PropagatorName. Units: N/A. 

SatListN 

Default: Defaults C. Options: [ Any existing spacecraft or formations, not being 
propagated by another propagator in the same Propagate event. Multiple spacecraft 
must be expressed in a comma delimited list format. ]: The SatListN option allows 
the user to enter all the satellites and/or formations they want to propagate using 
the PropagatorName propagator settings. The Spacecraft List GUI field stores all 
the data in SatListN. Units: N/A. 
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Table 3.1; Propagate Command . . .continued 


StopCondListN 

/Parameter 


StopCondListN 

/Condition 


Default: DefaultSC.ElapsedSecs =. Options; [ Any single element user accessi- 
ble spacecraft parameter followed by an equal sign ]. The StopCondListN option 
allows the user to enter all the parameters used for the propagator stopping condi- 
tion. See the StopCondListN/Condition Option/Fiekl for additional details to the 
StopCondListN option. Units: N/A. 

Default: 8640.0. Options: [ Real Number, Array element, Variable, spacecraft 
parameter, or any user defined parameter ]. The StopCondListN option allows 
the user to enter the propagator stopping condition’s value for the StopCondListN 
Parameter field. Units: Dependant on the condition selected. 


Script Examples 

% Single spacecraft propagation with one stopping condition 

% Syntax #1 

Propagate DefaultPr op (Default SC, {DefaultSC.ElapsedSecs « 8640.0}); 

% Single spacecraft propagation with one stopping condition 

% Syntax #2 

Propagate DefaultPr op (Default SC) {DefaultSC.ElapsedSecs ~ 8640.0}; 

% Single spacecraft propagation by one integration step 
Propagate Default Prop (Default SC) ; 

% Multiple spacecraft propagation by one integration step 
Propagate Def aultProp(Satl , Sat2, Sat3) ; 

% Single formation propagation by one integration step 
Propagate Def aultProp(Def aultFormation) ; 

% Single spacecraft backwards propagation by one integration step 
Propagate Backwards Def aultProp(Def aultSC) ; 

% Two spacecraft synchronized propagation with one stopping condition 

Propagate Synchronized DefaultProp(Satl , Sat2, {DefaultSC.ElapsedSecs ~ 8640.0}); 

% Multiple spacecraft propagation with multiple stopping conditions and propagation settings 

% Syntax #1 

Propagate Propl (Satl,Sat2, {Satl .ElapsedSecs - 8640.0, Sat2.MA - 90}) ... 
Prop2(Sat3, {Sat3.TA = 0.0}); 

% Multiple spacecraft propagation with multiple stopping conditions and propagation settings 

% Syntax #2 

Propagate Propl (Satl ,Sat2) {Satl .ElapsedSecs = 8640.0, Sat2.MA = 90} ... 

Prop2 (Sat3) {Sat3.TA - 0.0}; 
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3.2 Control Flow 


Table 3,2: If Command 


Script Syntax 


{Simple If statement) 

If <logical expression^ 

<Stat ements> ; 

End If ; 


( Compound If statement) 

If <logical expression | <logical expression & <logical expression; 

<Statements>; 

Endlf ; 


{If- Else statement) 

If <logical expression; 

<Statements>; 

Else; 

<Statements>; 

Endlf ; 


Option 

Option Description 

<logical expression> 

Default: DefaultSC .ElapsedDays <1.0. Options: [ Argl < Arg2 and < can 
be >, <, >=, <=, ==, ]. Argl and Arg2 can be any of the following: Real 

Number, Array element, Variable, Spacecraft Parameter or any other user de- 
fined parameter. Units: N/A. 

<Statements> 

Default: N/A. Options: [ Any script line that can be in the mission sequence ]. 
Units: N/A. 

! 

Default: N/A. Options: [N/A]. The 1 option allows the user to set an OR oper- 
ator in between <logical expressions. Units: N/A. 

& 

Default: N/A. Options: [N/A], The 1 option allows the user to set an AND 
operator in between <logical expressions. Units: N/A. 

Script Examples 


If DefaultSC .ElapsedDays < 1; 


Propagate Def aultProp ( DefaultSC , { DefaultSC .ElapsedDays = 0.01 }): 
Endlf; 

If My Variable < MyArray (1 ,1) ; 

MyArray Cl , 1) - 5: 

Endlf; 

If DefaultSC, Earth. TA < MyArray (1 ,2) ; 

Propagate DefaultPropC DefaultSC ); 

Endlf; 
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liable 3.3: While Command 


Script Syntax 


(Simple While Loop) 

While Clogical expression^ 

<Statements>; 

EndWhile; 


( Compound While Loop) 

While <logical expression> I <logical expression> & <logical expression> 
<Statements> 

EndWhile 


Option 

Option Description 

clogical expression Default: Def aultSC .ElapsedDays < 1.0. Options:[ Argl < Arg2 and < can be 
>, < ? >=: ? <=, ==, ]. Argl and Arg2 can be any of the following: Real Number. 

Array, Variable, Spacecraft Parameter or any other user defined parameter. Units: 
N/A. 

<Statements> 

Default: N/A. Options: [ Any script line that can be in the mission sequence ]. 
Units: N/A. 

i 

Default: N/A. Options: [N/A]. The I option allows the user to set an OR operator 
in between <logical expressions Units: N/A. 

t 

Default: N/A. Options: [N/A]. The | option allows the user to set an AND operator 
in between Clogical expressions. Units: N/A. 


Script Examples 


While Def aultSC . ElapsedDays < 1; 

Propagate DefaultPropC DefaultSC , { Def aultSC .ElapsedDays = 0.01 }); 

EndWhile; 


While MyVaxiable < HyArrayCl, 1) ; 
MyArray (1,1) = 5; 

EndWhile; 
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Table 3.4: Fox Command 


Script Syntax 


(Simple For Loop) 

For Variable - Start :End; 

<Statements>; 

EndFor; 

(Expanded For Loop) 

For Variable - Start : Increment : End; 

<Statements>; 

EndFor; 


Command Description 


The for loop is a control flow statement that allows portions of code to be executed iteratively using an 
explicit loop variable (Wikipedia). GMAT for loops are three-expression loops that allow the user to set 
the initial value of the loop variable, its increment, and the test to exit the loop. A parameter must be 
defined explicitly using a Create- Variable statement or GUI equivalent before it can be used in a for loop 
command statement. The only parameter type that can be used as a loop variable is the variable type. 
The parameters used to define Start, Increment, and End can be any of the following GMAT parameters: 
integer?? (real), variable, array element, spacecraft property. 


GMAT allows the for loop variable to be changed inside the loop by the user, and the resulting behavior of 
the for loop is equivalent to the behavior defined in ANSI C. If a change is made to the loop variable inside 
of the loop, if this change causes the exit test to be violated, GMAT will exit the for loop. 


Option 

Option Description 

Variable 

Default: No Default. Options:} Variable ]: The Variable option allows the user to 
define the variable that will store the For Loop numeric range. Units: N/A. 

Start 

Default: 1. Options: [ Real Number, Array element, Variable, or any user defined 
parameter ]. The Start option allows the user to set the starting numeric range 
value of the For Loop. Start can be equal to End, but the For Loop will not execute. 
Units: N/A. 

Increment 

Default: 1. Options: [ Real Number, Array element, Variable, or any user de- 
fined parameter ]. The Increment option allows the user to set the numeric range 
increment value of the For Loop. When the Increment option is left out of the 
script syntax the default value is used. If an Increment value of 0 is used, the 
For Loop should not execute but GMAT should continue to run. If End>Start 
and Increment < 0, then the For Loop should not execute. If St art > End and 
Increment > 0, then the For Loop should not execute. Units: N/A. 

End 

Default: 10. Options: [ Real Number, Array, Variable, or any user defined param- 
eter ]. The End option allows the user to set the ending numeric range value of the 
For Loop. End can be equal to Start, but the For Loop will not execute. Units: 
N/A. ■ 

Script Examples 

% Output the value of the For loop Variable to a file 
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Table 3.4: For Command . . . continued 


For I - 1:1:10; 

GMAT testVar - I; 

Report DefaultReportFile I; 

EndFor ; 
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3.3. SOLVER-RELATED 

3.3 Solver-related 





Table 3.5: Target Command 


Script Syntax 

Target SolverName ; 


<Statements> 


EndTarget ; 


Option 

Option Description 

SolverName 

Default: DefaultDC. Options: [ Any differential corrector existing in the resource 
tree or created in the script ]: The SolverName option allows the user to choose 
between any previously created differential correctors for use in a targeting sequence. 
For example, to begin a targeting sequence using DefaultDC, the script is Target 
DefaultDC. Units: N/A. 

<Statements> 

Default: None. Options: [ Any non-targeter and non-optimizer command lines used 
in the mission sequence, as well as the targeter dependent command lines Achieve 
and Vary.]: Units: N/A. 

Script Examples 

% Beginning and ending syntax for the Target command 

Target DefaultDC; 


EndTarget; 


Table 3-d: Optimize Command 


Script Syntax 


Optimize SolverName ; 

<Statements> 
EndOptimize ; 


Option 

Option Description 

SolverName 

Default: DefaultSQP. Options:[ Any existing optimizer ]: The SolverName field 
allows the user to choose between any previously created optimizer for use in 
an optimization sequence. For example, to begin a optimization sequence using 
DefaultSQP, the script is Optimize DefaultSQP. Units: N/A. 

Statements 

Default: None. Options: [ Any non-targeter and non-optimizer command lines used 
in the mission sequence, as well as the optimizer dependent command lines Vary, 
NonLinearConstraint, and Minimize. ]: Units: N/A. 

Script Examples 


% Beginning and ending syntax for the Optimize command 
Optimize DefaultDC; 


EndOptimize ; 
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Table 3.6: Optimize Command . . . continued 


Table 3.7: Achieve Command 


ScriptSyntax: Achieve SolverName (Goal = Argl, {Tolerance = Arg2}) ; 


Option Option Description 


Goal 


Argl 


Tolerance 


SolverName 


Default: DefaultSC.Earth.RMAG, Options: [ Spacecraft parameter, Array element, 
Variable, or any other single element user defined parameter, excluding numbers ]: 
The Goal option allows the user to select any single element user defined parameter, 
except a number, to Achieve. 

Default: 42165. Options: [ Real Number, Array element, Variable, or any user 
defined parameter that obeys the conditions of Chapter 2 for the selected Goal ] 
The Argl option is the desired value for Goal after the solver has converged. Units: 
N/A. 

Default: 0.1. Options: [ Real Number, Array element, Variable, or any user de- 
fined parameter > 0 ]: The Tolerance option sets Arg2. Arg2 is the convergence 
tolerance for Argl. Units: N/A. 

Default: DefaultDC. Options: [ Any user defined differential corrector ]: The Solver- 
Name option allows the user to choose which solver to assign to the Achieve com- 
mand. Units: N/A. 


Script Examples 


Achieve DefaultDC(DefaultSC.Earth.RMAG = 42165.0, {Tolerance = 0.1}); 


Table 3.8: Vary Command 



3.3. SOLVER-RELATED 


ScriptSyntax 


Vary SolverName {Variable ~ Initial Guess, {Perturbation = Argl ,MaxStep = Arg2, Lower = Arg3 , 
... Upper * Arg4, AdditiveScaleFactor - Arg5, MulitiplicativeScaleFactor ® Arg6}) 


Option Option Description 


Parameters Associated with All Solvers. 

SolverName Default: DefaultDC. Options: [ Any user defined solver ]: The SolverName option 

allows the user to choose which solver to assign to the vary command. Units: N/A. 

Variable Default: DefaultIB.V. Options: [ Spacecraft parameter, Array element, Variable, or 

any other single element user defined parameter, excluding numbers ] The Variable 
option allows the user to select any single element user defined parameter, except 
a number, to vary. For example, DefaultIB.V, DefaultIB.N, Default IB . Element 1 , 
Defaults C.TA, Array (1,1), and Variable are all valid values. The three element 
burn vector or multidimensional Arrays are not valid values. Units: N/A. 



CHAPTER- f COMMANDS AND EVENTS 


Table 3.8: Vary Command . . . continued 


Initial Guess Default: 0.5. Options: [ Real Number, Array element, Variable, or any user defined 

parameter that obeys the conditions of Chapter 2 for the selected Variable ]: The 
InitialGuess option allows the user to set the initial guess for the selected Variable. 
Units: km/s. 

Lower Default: 0.0 . Options: [ Real Number, Array element, Variable, or any user defined 

parameter (Upper > Lower ) ]: The Lower option allows the user to set Arg3 to the 
lower bound of the quantity being varied. Units: N/A. 

Upper Default: 3.14159 . Options: [ Real Number, Array element, Variable, or any user 

defined parameter (Upper > Lower ) ]: The Upper option allows the user to set 
Arg4 to the upper bound of the quantity being varied. Units: N/A. 


Parameters Associated with Differential Corrector. 

Perturbation Default: le~4 . Options: [ Real Number, Array element, Variable, or any user 

defined parameter > 0 ]: The Perturbation option is set by specifying a value for 
Argl. The value of Argl is the perturbation size in calculating the finite difference 
derivative. Units: N/A. 

MaxStep Default: 0,2 . Options: [ Real Number, Array element, Variable, or any user defined 

parameter > 0 ]: The MaxStep option is set by specifying a value for Arg2. The 
value of Arg2 limits the size of the step taken during an interaction of the differential 
corrector. Units: N/A. 


Parameters Associated with fmincon Optimizer. 

Additive Scale Default: 0 . Options: [ Real Number, Array element, Variable, or any user defined 

Factor parameter ]: The AdditiveScaleFactor Field is used to nondimensionalize the 

independent variable, fmincon sees only the nondimensional form of the variable. 
The nondimensionalization is performed using the following equation: x n — (x^ — 
a)/m . (x n is the non-dimensional parameter. Xd is the dimensional parameter. 
a = additive scale factor, m = multiplicative scale factor.) Units: N/A. 

Multiplicative Scale Default: 1.0 . Options: [ Real Number, Array element, Variable, or any user 
Factor defined parameter ]: The MultiplicativeScaleFactor Field is used to nondimen- 

sionalize the independent variable, fmincon sees only the nondimensional form of 
the variable. The nondimensionalization is performed using the following equation: 
x n = (xd — a)/m . (x n is the non-dimensional parameter. Xd is the dimensional 
parameter, a = additive scale factor, m = multiplicative scale factor.) Units: N/A. 


Script Examples 

% Impulsive Burn Vary Command 

Vary DefaultDC (Default IB .V ~ 0.5, {Perturbation = 0.0001, MaxStep =0.2, ... 
Lower = 0, Upper = 3.14159}); 


Table 3.9: Minimize Command 
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Script Syntax: Minimize Optimizer Name (Arg) 
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Table 3.9: Minimize Command . . . continued 


Option Option Description 

OptimizerName Default: SQP1. Options:[ Any existing fmincon solver ]: The Optimizer Name option 

allows the user to specify which solver to use to minimize the cost function. Units: 
N/A. 

Arg Default: Def aultSC.ECC. Options: [ Variable, Spacecraft parameter, or Array ele- 

ment]. The Arg field allows the user to specify the function to be minimized upon 
convergence of the solver given by OptimizerName . Arg can be any of the following: 
Variable, Array element, or Spacecraft Parameter or any other lxl numeric user 
defined parameter. Units: N/A. 

Script Examples 

% Minimize the eccentricity of Sat, using fminconSQP 
Minimize fminconSQP (Sat .ECC) ; 

% Minimize the Variable DeltaV, using fminconSQP 
Minimize fminconSQP (DeltaV) ; 

% Minimize the first component of My Array, using fminconSQP 
Minimize fminconSQP (MyArr ay (1,1)) ; 
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3.3 . SOLVER-RELATED 





T"\ 



Table 3.10: Non Idnear Constraint Command 


Script Syntax: NonLinearConstraint Opt imizerName (<logical expression>) 


Option Option Description 

Opt imizerName Default: SQP1. Options: [ Any existing fmincon solver ]: The Opt imizerName option 

allows the user to specify which solver to use in satisfying nonlinear constraints. 
Units: N/A. 

clogical expression> Default: Default SC .SMA = 7000. Options: [ Argl < Arg2 where < can he >= 
, <=, = ]. The logical expression field allows the user to specify the constraint to 
be satisfied upon convergence of the solver given by OptimizerName. Argl and 
Arg2 can be any of the following: Real Number, a 1-D Array (column vector), 
Array element, Variable, Spacecraft Parameter or any other numeric user defined 
parameter. If Argl is a 1-D Array, then Arg2 must be a 1-D Array with the same 
dimensions and vice-versa. Units: N/A. 


Script Examples 

% Constrain the SMA of Sat to be 7000 km, using fminconSQP 
NonLinearConstraint fminconSQP ( Sat. SMA = 7000 ); 

% Constrain the SMA of Sat to be less than or equal to 7000 km, using fminconSQP 
NonLinearConstraint fminconSQP ( Sat. SMA <= 7000 ); 

% Constrain the SMA of Sat to be greater than or equal to 7000 km, using fminconSQP 
NonLinearConstraint fminconSQP C Sat. SMA >= 7000a ); 
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3.4 Miscellaneous 


CHAPTER 3. 


COMMANDS AND EVENTS 


Table 3.11: Maneuver Command 


Script Syntax: Maneuver BurnName ( SpacecraftName ) ; 


Option 

Option Description 

BurnName 

Default: Default IB. Options: [ Any impulsive bum existing in the resource tree or 
created in the script]: The BurnName field allows the user to choose between any 
previously created impulsive burn. As an example, to maneuver Default SC us- 
ing Default IB, the script line would appear as Manevuer Default IB (Def aultSC) . 
Units: N/A. 

Spacecraf tNam e 

Default: Def aultSC. Options/ Any spacecraft existing in the resource tree or cre- 
ated in the script]: The SpacecraftName field allows the user to select which space- 
craft to maneuver using the maneuver selected in the BurnName field. 

Units: N/A. 


Script Examples 


% Impulsive Burn 

Maneuver DefaultIB (Def aultSC) ; 


Table 3.12: BeginFinit eB urn Command 


Script Syntax: BeginFiuiteBum ManeuverName ( SpacecraftName ) ; 


Option Option Description 

ManeuverName Default: DefaultFB. Options: [ Any finite burn existing in the resource tree or cre- 

ated in the script]: The ManeuverName option allows the user to choose between 
any previously created finite burn. As an example, to maneuver Default SC us- 
ing DefaultFB, the script line would appear as Manevuer Def aultFB(Def aultSC) . 
Units: N/A. 

SpacecraftName Default: Def aultSC. Options: [ Any spacecraft existing in the resource tree or cre- 

ated in the script]: The SpacecraftName option allows the user to select which 
spacecraft to maneuver using the maneuver selected in the ManeuverName option. 
Units: N/A. 


Script Examples 

% Default BeginFiniteBurn syntax 
BeginFiuiteBum Def aultFB (Def aultSC) ; 


Table 3.13: EndFinifceBum Command 
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Script Syntax: EndFiniteBurn ManeuverName (SpacecraftName) ; 


Option 

Option Description 

ManeuverName 

Default: DefaultFB. Options: [ Any finite burn existing in the resource tree or cre- 
ated in the script]: The ManeuverName option allows the user to choose between 
any previously created finite burn. As an example, to maneuver Default SC us- 
ing DefaultFB, the script line would appear as Manevuer DefaultFB (DefaultSC) . 
Units: N/A. 

SpacecraftName 

Default: DefaultSC. Options: [ Any spacecraft existing in the resource tree or cre- 
ated in the script]: The SpacecraftName option allows the user to select which 
spacecraft to maneuver using the maneuver selected in the ManeuverName option. 
Units: N/A. 

Script Examples 

% Default EndFiniteBurn syntax 
EndFiniteBurn DefaultFB (Default SC) ; 


Table 3.14: CallFiinction Command 


Script Syntax 


Function call with Inputs and Outputs 

GMAT [OutputList] = Function (InputList) 

Function call with Outputs only 
GMAT [OutputList] * Function 

Function call with Inputs only 
GMAT Fund ion (InputLi st) 

Function call with no Inputs or Outputs 
GMAT Function 


Option 

OutputList 


InputLi st 


Function 


Option Description 

Default: None. Options: [ Variables, Arrays, S/C Paramters, any other user-defined 
parameters, or blank. M\iltiple outputs must be expressed in a comma delimited 
list format ]: The OutputList option allows the user to set the output of Function 
to a user defined parameter. Units: N/A. 

Default: None. Options: [ Variablas, Arrays, S/C Paramters, any other user-defined 
parameters, or blank. Multiple inputs must be expressed in a comma delimited list 
format. ]: The InputLi st option allows the user to set the input of Function to a 
user defined parameter. Units: N/A. 

Default: None. Options: [ GMAT of Mat lab Function ]: The Function option allows 
the user to set the function that will be called in a specific location of the mission 
sequence. The function has to be defined before it can be used in the CallFunction 
Command. Units: N/A. 


Script Examples 
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Table 3.14: CallFunction Command . . . continued 


% Matlah function call without inputs or outputs 

% Syntax 1 
GMAT clear All; 

% Matlab function call without inputs or outputs 

% Syntax 2 

GMAT [ ] = clear All( ); 


Table 3.15: Toggle Command 


Script Syntax: Toggle OutputNames Arg 


Option Option Description 

OutputNames Default: DefaultOpenGL . Options: [ Any OpenGL, Report, XYpIot,^)r any other 

Plot/Report type ]: The Toggle option allows the user to assign the Plot/ Report (s) 
to be toggled. When more than one Plot /Report is being toggled they need to be 
separated by a space. Units: N/A, 

Arg Default: On. Options: [ On or Off ]: The Arg option allows the user to turn off or 

on the data output to a Plot/Report. Units: N/A. 


Script Examples 

% Turn off Report file for the first day of propagation 
Toggle ReportFilel Off 

Propagate DefaultPr op (Default SC, DefaultSC.ElapsedDays - 1); 
Toggle ReportFilel On 

Propagate DefaultProp (Default SC, DefaultSC.ElapsedDays * 1) ; 

% Turn off XYPlot and Report file for the first day of propagation 
Toggle XYPlot 1 ReportFilel Off 

Propagate DefaultProp (Default SC, DefaultSC.ElapsedDays = 1) ; 
Toggle XYPlot 1 ReportFilel On 

Propagate DefaultProp (Default SC, DefaultSC.ElapsedDays * 1) ; 


Table 3.10: Report Command 
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MISCELLANEOUS 



Script Syntax: Report ReportName DataList 


Option 

Option Description 

ReportName 

Default: N/A. Options: [ Any ReportFile created ]: The ReportName option allows 
the user to specify the ReportFile for data output. Units: N/A. 

DataList 

Default: N/A. Options: [ Spacecraft parameter, Array, Variable, String, or any other 
single user defined parameter ]: The DataList option allows the user to output 
data to the Filename specified by the ReportName. Multiple objects can be in the 
DataList when they are separated by spaces. Units: N/A. 
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Table 3.16: Report Command . . .continued 


Script Examples 

% Report the time and position of DefaultSC 

Report DefaultReport DefaultSC. AlMod Julian DefaultSC, X DefaultSC. Y 

DefaultSC. Z; 

Table 3.17: Script Event Command 

Script Syntax 

BeginScript ; 



<Statements>; 



EndScript ; 



Option 

Option Description 


<Statements> 

Default: N/A. Options: [ Any valid line of GMAT script 

]. Units: N/A. 

Script Examples 


% Assignment command inside Script Event 
8eginScri.pt ; 


GMAT testVar - 24; 
EndScript ; 


Table 3.18: Pause Command 


Script Syntax: Pause 


Comm and Description 

The Pause command allows the user to pause a nrnning GMAT script. 


Script Examples 

% Pause between propagation sequences 

Propagate DefaultPr op (Default SC) DefaultSC.ElapsedSecs = 8640.0; 

Pause ; 

Propagate DefaultPr op (Default SC) DefaultSC . ElapsedDays ~ 10.0; 


Tabic 3.19: Stop Command 


Script Syntax: Stop 


Command Description 

The Stop command allows the user to stop a running GMAT script. 


Script Examples 

% Stop between propagation sequences 

Propagate DefaultPr op (DefaultSC) DefaultSC.ElapsedSecs * 8640.0; 

Stop; 
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Table 3.19: Stop Command . . .continued 


Propagate Default Prop (DefaultSC) Default SC. ElapsedDays = 10.0; 


Table 3.20: Save Command 

Script Syntax: Save 

ObjectList 

Option 

Option Description 

ObjectList 

Default: DefaultSC. Options: [ Any user-defined objects, excluding variables and 
arrays ]: The ObjectList option allows the user to save the properties of the 
objects selected to the output path. Multiple objects can be in the ObjectList 
when they are separated by spaces. Units: N/A. 


Script Examples 


% Save Default SC data after a 1 day propagation 

Propagate DefaultProp (DefaultSC, DefaultSC .ElapsedDays = 1); 
Save DefaultSC; 

% Save Impulsive Burn and DefaultSC data after a Target er sequence 
EndTarget ; 

Save Default IB DefaultSC; 
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